home *** CD-ROM | disk | FTP | other *** search
/ SGI Desktop Special Edition 1.0 / SGI Desktop Special Edition 1.0.iso / relnotes / dmedia_eoe / ch03.z / ch03
Text File  |  1995-09-11  |  19KB  |  529 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        3.  _D_i_g_i_t_a_l__A_u_d_i_o
  9.  
  10.  
  11.        An IRIS Audio Processor is included with the Personal IRIS
  12.        4D/3X, IRIS Indigo, Indigo, and Indy systems.  Included
  13.        with the audio system are a number of utility programs for
  14.        recording, processing, and playing digital audio. This
  15.        section details the changes, known bugs, and caveats in the
  16.        audio system itself, as well as in most of the bundled audio
  17.        utilities. The exceptions to this are _s_o_u_n_d_e_d_i_t_o_r,
  18.        _s_o_u_n_d_f_i_l_e_r, _c_d_m_a_n, and _d_a_t_m_a_n, for which release notes may
  19.        be found under the "Digital Media Tools" section.
  20.  
  21.  
  22.        3.1  _A_u_d_i_o__S_y_s_t_e_m
  23.  
  24.  
  25.  
  26.        3.1.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s   The audio system in IRIS
  27.        Digital Media Execution Environment 5.5 is the same as the
  28.        5.3 version.
  29.  
  30.        This section lists changes and additions made between the
  31.        5.2 and 5.3 releases.
  32.  
  33.  
  34.           +o IRIX 5.3 includes support for accurate synchronization
  35.             between audio and other media.  For information on how
  36.             to use these new features, please refer to the
  37.             dmedia_dev release notes and the Digital Media
  38.             Programmer's Guide.
  39.  
  40.           +o The performance of the monitor function has been
  41.             significantly improved. It requires substantially less
  42.             CPU and has much lower latency from input to output.
  43.  
  44.           +o The audio driver is now dynamically loadable. It is
  45.             automatically registered on systems which have audio
  46.             capabilities, and will be loaded upon the first
  47.             attempted use of audio.
  48.  
  49.  
  50.        3.1.2  _B_u_g__F_i_x_e_s
  51.  
  52.           +o 5.2 had some subtle problems with sample rates in
  53.             four-channel mode. These have been fixed in 5.3.
  54.  
  55.  
  56.        3.1.3  _C_a_v_e_a_t_s
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.           +o When there is nothing physically connected to the
  75.             digital I/O jack, it is meaningless to set the system
  76.             sample rates in the following three ways:
  77.  
  78.                +o output sample rate set to match the input sample
  79.                  rate while using digital input as the system
  80.                  input.
  81.  
  82.                +o input sample rate set to the digital rate and the
  83.                  output rate set to match the input rate.
  84.  
  85.                +o input sample rate set to the digital rate and the
  86.                  output rate set to the digital input rate.
  87.             When the system is put in any of these states, the
  88.             sample rate is undefined.
  89.  
  90.           +o The IRIS Audio Processor hardware subsystem on all
  91.             platforms except 4D/35 and 4D/30 includes a direct
  92.             digital loopback channel, which makes a connection
  93.             between digital out and digital in when nothing is
  94.             plugged into the digital audio I/O jack. In effect,
  95.             this mechanism allows you to record the current output
  96.             of the machine by using the digital input when nothing
  97.             is connected to the digital I/O jack.
  98.  
  99.             However, If you select Digital In on _a_u_d_i_o_p_a_n_e_l while
  100.             the direct digital loopback channel is enabled, then
  101.             select Monitor, you may hear feedback due to the
  102.             physical loopback channel.
  103.  
  104.             Workaround: Avoid monitoring when Digital In is
  105.             selected and nothing is plugged into the digital I/O
  106.             jack (there's nothing to monitor in this case anyway).
  107.             An alternative is to keep a jack plugged into the
  108.             digital I/O jack (this doesn't have to be a live
  109.             connection) to physically defeat the loopback
  110.             mechanism.
  111.  
  112.  
  113.        3.2  _A_u_d_i_o__C_o_n_t_r_o_l__P_a_n_e_l__(_a_u_d_i_o_p_a_n_e_l_)
  114.  
  115.  
  116.  
  117.        3.2.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s   The Audio Control Panel in
  118.        IRIS Digital Media Execution Environment 5.5 is the same as
  119.        the 5.3 version.
  120.  
  121.        This section lists changes and additions made between the
  122.        5.2 and 5.3 releases.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.           +o The on-line help information has been rewritten and
  141.             expanded.
  142.  
  143.           +o Can specify AES (negative) input/output sampling rates
  144.             on command line as arguments to -rate options.
  145.  
  146.           +o Added support under Options menu for control of audio
  147.             features in Indy Presenter LCD option.  This menu item
  148.             appears only in the presence of the Presenter graphics
  149.             option.
  150.  
  151.  
  152.        3.2.2  _B_u_g__F_i_x_e_s
  153.  
  154.           +o No longer crashes when switching from 2 channel to 4
  155.             channel mode with the metering function enabled.
  156.  
  157.           +o Corrected delayed response of meters at low input
  158.             sampling rates.
  159.  
  160.           +o audiopanel ignores X resource geometry dimensions but
  161.             now responds to coordinates.  audiopanel does not
  162.             resize.
  163.  
  164.           +o audiopanel now shows all sampling rates rates, 8.82 kHz
  165.             etc., and all AES rates, including Digital/2,
  166.             Digital/3, etc.
  167.  
  168.  
  169.        3.2.3  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  170.  
  171.           +o If your environment variable DISPLAY is not set,
  172.             audiopanel will not run, even with -nodisplay option.
  173.  
  174.           +o The input level meters do not reliably display signal
  175.             peaks. The primary cause is the presence of DC offset,
  176.             which is currently removed with a complementary box
  177.             filter of length 256.  This algorithm removes only a
  178.             respectable amount of the DC offset at a minimum CPU
  179.             cost.  The secondary cause is the audiopanel metering
  180.             routine does not keep up with the input sample stream
  181.             at rates above 32000 Hz.
  182.  
  183.           +o The minimum input slider position does not correspond
  184.             to infinite attenuation on Indy and Indigo2.  This is
  185.             an audio hardware limitation.
  186.  
  187.           +o audiopanel configuration files may not contain empty
  188.             lines or comments after those that head the file.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        3.3  _A_u_d_i_o__U_t_i_l_i_t_y__P_r_o_g_r_a_m_s
  207.  
  208.  
  209.  
  210.        IRIS Digital Media Execution Environment 5.5 includes a
  211.        number of command-line utility programs that allow you to
  212.        record, play back, and process sound files:
  213.  
  214.  
  215.  
  216.        The audio execution environment _d_m_e_d_i_a__e_o_e._s_w._a_u_d_i_o contains
  217.        the following command line utility programs:
  218.  
  219.           +o _p_l_a_y_a_i_f_c(1)     AIFF, AIFF-C sound file player
  220.  
  221.           +o _p_l_a_y_a_i_f_f(1)     installed as a symbolic link to
  222.             _p_l_a_y_a_i_f_c
  223.  
  224.           +o _s_f_p_l_a_y(1)       sound file player
  225.  
  226.           +o _r_e_c_o_r_d_a_i_f_c(1)   AIFF, AIFF-C sound file recorder
  227.  
  228.           +o _r_e_c_o_r_d_a_i_f_f(1)   installed as a symbolic link _r_e_c_o_r_d_a_i_f_c
  229.  
  230.           +o _a_i_f_c_i_n_f_o(1)     displays information about AIFF-C, AIFF
  231.             files
  232.  
  233.           +o _s_f_i_n_f_o(1)       displays information about sound files
  234.  
  235.           +o _a_i_f_c_r_e_s_a_m_p_l_e(1)         sampling rate conversion
  236.             utility
  237.  
  238.           +o _a_i_f_f_2_a_i_f_c(1)            converts an AIFF file to an
  239.             AIFF-C file
  240.  
  241.           +o _a_i_f_c_2_a_i_f_f(1)    converts an AIFF-C file to an AIFF file
  242.  
  243.           +o _a_i_f_c_c_o_m_p_r_e_s_s(1) converts an AIFF or AIFF-C file to a
  244.             compressed format
  245.  
  246.           +o _a_i_f_c_d_e_c_o_m_p_r_e_s_s(1)       decompresses an AIFF-C file
  247.  
  248.           +o _s_f_c_o_n_v_e_r_t(1)    sound file conversion utility
  249.  
  250.           +o _p_o_r_t_s_t_a_t(1)     displays status of all open audio ports
  251.             on system
  252.  
  253.           +o _r_b_v_i_e_w(1)         graphically displays status of audio
  254.             ports
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.           +o _p_a_s_s_t_h_r_u(1)     user-level audio input monitor utility
  273.  
  274.  
  275.        The audio execution environment _d_m_e_d_i_a__e_o_e._s_w._a_u_d_i_o also
  276.        contains these DSO's (dynamically shared objects):
  277.  
  278.           +o _l_i_b_a_u_d_i_o_f_i_l_e._s_o    Audio File Library DSO
  279.  
  280.           +o _l_i_b_a_u_d_i_o_u_t_i_l._s_o    Audio Utility Library DSO
  281.  
  282.  
  283.        These DSO's have no dependencies on the IRIS Audio Library
  284.        or IRIS Audio Processor hardware. The Audio File Library
  285.        contains routines for performing AIFF/AIFF-C disk file
  286.        access. The Audio Utility Library contains low-level
  287.        routines for audio data conversion (most of these routines
  288.        are invoked internally from the Audio File Library).
  289.  
  290.        Header files and programming guide information for the Audio
  291.        File Library and Audio Utility Library are included with
  292.        IRIS Digital Media Development Environment 5.3.
  293.  
  294.        Aware,Inc compression routines are invoked internally from
  295.        the Audio File Library and Audio Utility Library. In order
  296.        to enable the Aware,Inc software codecs on your system, you
  297.        must purchase a NetLS license from Aware,Inc. See "Chapter
  298.        7: Compression Library Execution Environment" in these
  299.        release notes for more information.
  300.  
  301.        Note that there are two different "families" of sound file
  302.        utility commands which overlap somewhat in functionality.
  303.        The first family of programs consists of _p_l_a_y_a_i_f[_f_c],
  304.        _r_e_c_o_r_d_a_i_f[_f_c], _a_i_f_c_i_n_f_o, _a_i_f_f_2_a_i_f_c, _a_i_f_c_2_a_i_f_f, _a_i_f_c_c_o_m_p_r_e_s_s,
  305.        _a_i_f_c_d_e_c_o_m_p_r_e_s_s, and _a_i_f_c_r_e_s_a_m_p_l_e. The second family consists
  306.        of _s_f_p_l_a_y, _s_f_i_n_f_o, and _s_f_c_o_n_v_e_r_t.
  307.  
  308.        The first set of programs are built on top of the Silicon
  309.        Graphics Audio File Library, and support the audio
  310.        compression algorithms for AIFF-C, which are built into the
  311.        library (CCITT G.711 and CCITT G.722, Aware,Inc MPEG and
  312.        MultiRate  codecs).  4DGifts source code for each of the
  313.        utilities (except for _a_i_f_c_r_e_s_a_m_p_l_e, which contains
  314.        proprietary high-quality rate-conversion code) is included
  315.        in the IRIS Digital Media Development Environment 5.3.
  316.  
  317.        The second set of programs share source code with _S_o_u_n_d
  318.        _F_i_l_e_r (included in the IRIS Digital Media Tools 5.5
  319.        subsystem _d_m_e_d_i_a__t_o_o_l_s._s_w._s_o_u_n_d_t_o_o_l_s).  These program
  320.        support additional file formats (NeXT/Sunr, Microsoftr RIFF
  321.        WAVE). However, they are not as full-featured as the
  322.        programs in the first set when it comes to AIFF and AIFF-C
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.        files. For example, the file conversion programs in the
  339.        first set (_a_i_f_c_2_a_i_f_f, _a_i_f_c_r_e_s_a_m_p_l_e, etc) preserve the
  340.        auxiliary nonaudio data (loop points, author string,
  341.        application-specific data) stored in the various optional
  342.        AIFF-C (AIFF) header fields. _s_f_c_o_n_v_e_r_t does not preserve
  343.        these header chunks across conversions.
  344.  
  345.        We are working to simplify this somewhat confusing situation
  346.        by merging corresponding tools from the two families (e.g.,
  347.        combine _p_l_a_y_a_i_f_c and _s_f_p_l_a_y into a single program which
  348.        supports both existing command-line interfaces). We hope
  349.        that new versions of the audio utilities will be available
  350.        by the next major IRIX release following 5.3.
  351.  
  352.  
  353.        3.3.1  _A_I_F_F_-_C__a_n_d__A_I_F_F__F_i_l_e__F_o_r_m_a_t_s   Beginning with the
  354.        IRIX 4.0.1 software release, Silicon Graphics introduced
  355.        AIFF-C (Audio Interchange File Format with Compression
  356.        extensions) as its standard audio interchange file format.
  357.        The AIFF-C format is an extended version of the AIFF format,
  358.        supported by Silicon Graphics and Apple digital media
  359.        applications.  AIFF-C files can store either compressed
  360.        audio data or standard linear PCM data, and optionally
  361.        include header fields that store many kinds of additional
  362.        information such as text, sample parameters, sample frame
  363.        markers, and application-defined data.  AIFF is not a proper
  364.        subset of the AIFF-C format. AIFF-C adds new header fields
  365.        for compression scheme identification which break
  366.        compatibility with the older AIFF format.
  367.  
  368.        By the IRIX 4.0.5F release, many of the digital media tools
  369.        such as Sound Editor (included in
  370.        _d_m_e_d_i_a__t_o_o_l_s._s_w._s_o_u_n_d_t_o_o_l_s) had been revised so that they
  371.        could read both AIFF and AIFF-C input files, but would write
  372.        only AIFF-C output files for both uncompressed and
  373.        compressed output. Unfortunately, many popular applications
  374.        for other platforms continue to support only the older AIFF
  375.        format.  For the 5.3 release, many of the sound file
  376.        conversion utilities were modified so that the output file
  377.        retains the format of the input file.
  378.  
  379.  
  380.        3.3.2  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s   This section lists changes
  381.        and additions since the 5.2 release.
  382.  
  383.  
  384.           +o The new program _p_o_r_t_s_t_a_t(1) prints the status of all
  385.             the currently open audio ports on a system.
  386.  
  387.           +o The new program _r_b_v_i_e_w(1) graphically displays the
  388.             audio sample queue levels for all the open audio ports
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.             on a system.
  405.  
  406.  
  407.        3.3.3  _B_u_g__F_i_x_e_s   This section lists the bugs fixed since
  408.        the 5.2 release.
  409.  
  410.  
  411.           +o Restored sampling rate conversion algorithms for
  412.             _a_i_f_c_r_e_s_a_m_p_l_e and _s_f_c_o_n_v_e_r_t:  due to a tragic
  413.             programming error, the IRIX 5.2 were rendered useless.
  414.  
  415.           +o _a_i_f_c_r_e_s_a_m_p_l_e now outputs a compressed file when the
  416.             input file is compressed
  417.  
  418.  
  419.        This section lists the bugs fixed since version 5.4 of the
  420.        Digital Media Execution Environment.
  421.  
  422.  
  423.           +o Fixed sample rate conversion for the 48 kHz to 44.1 kHz
  424.             case for both _a_i_f_c_r_e_s_a_m_p_l_e and _s_f_c_o_n_v_e_r_t.
  425.  
  426.  
  427.        3.3.4  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s   This section lists
  428.        known problems in the Digital Media Execution Environment
  429.        5.5 release, and ways to work around them.
  430.  
  431.           +o MPEG audio, Awarer MultiRate and G.722 compression and
  432.             decompression schemes are CPU-intensive.
  433.  
  434.             Workaround: To record or play back an AIFF-C file that
  435.             contains mono or stereo audio data compressed using
  436.             these algorithms, you might have to run _r_e_c_o_r_d_a_i_f_c(1)
  437.             or _p_l_a_y_a_i_f_c(1) with a nondegrading high priority. See
  438.             the man page _n_p_r_i(1) for information about how to do
  439.             this. An alternative is to record and play uncompressed
  440.             audio sample data, and compression/decompress the data
  441.             "offline" using the utilities _a_i_f_c_c_o_m_p_r_e_s_s(1) and
  442.             _a_i_f_c_d_e_c_o_m_p_r_e_s_s(1). These utilities are included in the
  443.             _d_m_e_d_i_a__t_o_o_l_s._s_w._s_o_u_n_d_t_o_o_l_s subsystem of IRIS Digital
  444.             Media Tools 5.3.
  445.  
  446.           +o _p_l_a_y_a_i_f_c cannot decode the Apple proprietary
  447.             compression schemes (ACE/MAC algorithms) described in
  448.             the AIFF-C specification. Similarly, Mac sound
  449.             applications may not be able to decode AIFF-C data
  450.             which was encoded on an SGI workstation using MPEG
  451.             audio compression,  Aware,Inc MultiRate compression,
  452.             G.722  compression, or G.711 compression.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                   - 8 -
  467.  
  468.  
  469.  
  470.             Workaround: Always decompress AIFF-C audio data before
  471.             transferring between Macintosh and SGI systems.
  472.  
  473.           +o _s_f_c_o_n_v_e_r_t now writes little-endian integer sample
  474.             files, but it does not yet write little-endian
  475.             floating-point output files.  Currently, the only file
  476.             format that requires little-endian support is WAVE, and
  477.             it does not support floating point samples, so this is
  478.             an issue only when transferring raw floating point data
  479.             files between an SGI platform and a little-endian
  480.             machine.
  481.  
  482.           +o _s_f_i_n_f_o omits some of the audio header information
  483.             stored in AIFF/AIFF-C files.
  484.  
  485.             Workaround:  use _a_i_f_c_i_n_f_o to obtain a more detailed
  486.             description of the audio data and auxiliary information
  487.             stored in an AIFF-C or AIFF file.  Note that _a_i_f_c_i_n_f_o
  488.             understands only AIFF-C and AIFF files, while _s_f_i_n_f_o
  489.             understands several additional formats.
  490.  
  491.           +o None of the AIFF-C conversion programs recognize the
  492.             comment-marker chunk described in the AIFF-C
  493.             specification.  This chunk disappears when a file is
  494.             converted using one of the utilities.
  495.  
  496.           +o The AIFF-C utility programs are not able to decode the
  497.             Apple proprietary audio compression schemes (ACE/MAC
  498.             algorithms) described in the AIFF-C specification.
  499.  
  500.             Workaround: Always uncompress AIFF-C files before
  501.             transferring them from a Macintosh to an SGI platform.
  502.  
  503.           +o _a_i_f_c_r_e_s_a_m_p_l_e does not modify the optional AES channel
  504.             status information in the AIFF-C file header to reflect
  505.             the new sampling rate.
  506.  
  507.             Workaround:  If the AES channel status information says
  508.             the audio data should be played at one rate, and the
  509.             AIFF-C (AIFF) file header says the audio data should be
  510.             played at another rate, go with sampling rate in the
  511.             file header.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.